ClonePartInfo

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODPart

ClonePartInfo
The ClonePartInfo method should clone a display frame's part info data into the specified storage-unit view object.
void ClonePartInfo (in ODDraftKey key,
                    in ODInfoType partInfo,
                    in ODStorageUnitView storageUnitView,
                    in ODFrame scope);
key
The draft key identifying a particular cloning operation, expressed as a 32-bit value. The key provides thread-safe access to cloning.
partInfo
The part info data to clone.
storageUnitView
A reference to a storage-unit view object that is focused to the frame's part info property, but not to any value within that property.
scope
A reference to a display frame that defines the scope of the cloning operation. All storage units cloned must be within the scope of the specified frame.

DISCUSSION
When a document is saved as a copy (using the Save a Copy command from the Document menu) or data is transferred (using drag and drop or linking), OpenDoc may ask your part to save a display frame's part info data to a particular storage unit. OpenDoc calls this method when it writes the part info data for a display frame of your part.
Your part's ClonePartInfo method must get the storage unit associated with the specified storage-unit view and focus it to the value(s) in the frame's part info property as necessary to write the formats it needs.
Your part's ClonePartInfo method should write out the part info data. Your part's ClonePartInfo method should also clone any additional objects to which your part has strong persistent references and that are within the specified display frame's scope.

OVERRIDING
When you subclass ODPart, you must override this method. Your override method must not call its inherited method; that is, your override method must implement this method's functionality completely.

SEE ALSO
The ODDraftKey type (page 902).
The ODInfoType type (page 883).
The ODPart::ReadPartInfo method (page 538).
The ODPart::WritePartInfo method (page 553).
"The ClonePartInfo Method" on page 112 in OpenDoc Cookbook.
"Required and optional ODPart overrides" on page 89 in OpenDoc Programmer's Guide.
"The ClonePartInfo Method of Your Part Editor" on page 329 in OpenDoc Programmer's Guide.